home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / pstats20.zip / RIMEBULL.DOC < prev    next >
Text File  |  1993-06-08  |  7KB  |  171 lines
  1.                    Postlink RIME Mail Statistics
  2.                          Bulletin Generator
  3.                     (c) 1993  Gregory R. Barton
  4.                 ═══════════════════════════════════
  5.  
  6. Purpose:
  7. ────────
  8.     This program was written so that users of my BBS could
  9.     quickly see what time the last RIME mail run occurred
  10.     and specifically, what kind of messages were exported
  11.     and imported in each conference.  This bulletin will
  12.     also total all exported and imported messages.
  13.  
  14. Packing List:
  15. ─────────────
  16.     The following files are included in this archive:
  17.         RIMEBULL.EXE   -  The main executable file.
  18.         RIMEBULL.DOC   -  The file you are reading now.
  19.         RIMEBULL.CFG   -  Sample configuration file.
  20.         SAMPLE.BAT     -  Batch file to view the
  21.                       enclosed sample bulletin in
  22.                                   color.
  23.         SHOWNEWS.EXE   -  Utility I wrote to view files
  24.                       created with PCBoard "@Xnn"
  25.                               codes in color at the DOS prompt.
  26.            BLTX           -  Sample bulletin created with
  27.                           RIMEBULL.
  28.                 POSTLINK.TXT   -  Sample POSTLINK log file.
  29.         FILE_ID.DIZ    -  PCBoard description file.
  30.  
  31. Setup:
  32. ──────
  33.     First of all, you will need to go into your POSTLINK.CFG
  34.     configuration file and make sure that the following line
  35.     exists:
  36.     
  37.             LOG=[d:]\postlink\postlink.txt
  38.     
  39.      This line will write a PCBoard caller's log-type file to
  40.     disk.  In this case, called POSTLINK.TXT.  You may name
  41.     this file anything you'd like, provided it meets DOS
  42.     filename requirements.  Also notice above that the [d:]
  43.     in the drive-letter position means the drive your POSTLINK
  44.     files reside.
  45.  
  46.         Special Note:  RIMEBULL reads only the first POSTLINK run
  47.         in this LOG file.  You will need to make a NEW LOG file
  48.         after every mail run for RIMEBULL to operate correctly.
  49.         On my system, I simply make a backup of my LOG file and
  50.         then delete it in my event.  The next Postlink mail run
  51.         will then create a new LOG file.
  52.  
  53.     Next, you'll need to use an ASCII editor to make up a
  54.     RIMEBULL.CFG file.  The format of this file is simple:
  55.         
  56.         Your BBS Name Here                   ;40 chars. max
  57.         Name of LOG file Postlink creates
  58.         Name of bulletin you wish to create
  59.         Title of bulletin you wish to create ;20 chars. max
  60.  
  61.     For instance, here is how my RIMEBULL.CFG file reads for my
  62.     own BBS (inluded in this archive):
  63.  
  64.         Alachua    County Computer Users Group
  65.         POSTLINK.TXT    
  66.         BLT18
  67.         Bulletin #18
  68.  
  69.     Once you have created your RIMEBULL.CFG file, save it and put
  70.     it in the same subdirectory as your RIMEBULL.EXE file.
  71.  
  72.         Special Note:  In the previous version (1.1), you had to specify
  73.         an "A" or "M" to tell RIMEBULL what kind of IMPORT mode you used
  74.         (AUTOMATIC or MANUAL).  RIMEBULL now searches the log by a 
  75.         different method and does not have to rely on the method that the
  76.         log file is written.  This will hopefully work for any configuration
  77.         POSTLINK is run in, but please let me know of any instances where
  78.         the software fails to perform.
  79.  
  80. Running the Program:
  81. ────────────────────
  82.     To run this program, perform your POSTLINK mail run as usual.
  83.     Once the mail run has finished, Postlink will have created
  84.     the LOG file you specified in the POSTLINK.CFG file.  Now,
  85.     simply type:
  86.  
  87.              RIMEBULL config-file
  88.  
  89.         at the DOS prompt and your bulletin (as    specified in your 
  90.         RIMEBULL.CFG file) will be created.
  91.           
  92.     Here is a sample (minus the PCBoard "@Xnn" codes) of the
  93.     output RIMEBULL creates:
  94.  
  95.             ┌──────────────┐             Alachua County Computer Users Group
  96.   ──────────┤ Bulletin #18 ├──────────────────────────────────────────────────
  97.             └──────────────┘                                        04-02-93
  98.  
  99.             The last RIME mail run was on 04-02-93 at 09:04 hours.
  100.  
  101.                The following message statistics were generated:
  102.  
  103.       Conference        Exp   Imp           Conference          Exp   Imp
  104.     ───────────────     ───   ───         ───────────────       ───   ───
  105.     For $ale Echo        0    394         Common                 0    104
  106.     Tech Echo            0    107         Desktop Pub            0     24
  107.     Communication        0     17         Programming            0     37
  108.     Database             0      4         Windows                0    263
  109.     Job Bank             0     21         Shareware              0     56
  110.     Star Trek            0    229         Sound Cards            0     41
  111.     dCOM                 0      0         Strange                0     24
  112.     RIME News            0      0         PCRelay                0      6
  113.     Bible Studies        2    127         Flight SIMS            0     17
  114.     DOS                  0     47         PCB Support            0     37
  115.     RIME Sysop           0      0         LOCALBBS               1      0
  116.  
  117.        Totals:  Messages Exported -    3     Messages Imported - 1555
  118.  
  119.   ────────────────────────────[ End Bulletin #18 ]────────────────────────────
  120.  
  121.     For a COLOR sample of the above output, type SAMPLE at the DOS
  122.     prompt to display this same file in color (included in this
  123.     archive).
  124.     
  125. Other Info:
  126. ───────────
  127.     Included in this archive is another utility I wrote called
  128.     SHOWNEWS.EXE.  This little utility will allow you to view
  129.     files created with PCBoard "@Xnn" codes in color from the
  130.     DOS prompt.
  131.  
  132.     This program is also based on my first shareware program I
  133.     wrote, called NEWSMAKER (current version is NWSMKR31.ZIP,
  134.     available on Salt-Air BBS and several shareware CDROMS).
  135.     It is a utility that will allow you to automatically color
  136.     NEWS files for PCBoard and add a nice, headered output.
  137.  
  138. Registration:
  139. ─────────────
  140.     You are allowed to use this program for FREE for the first
  141.     30 days.  However, if you wish to use it beyond that period,
  142.     you must register it with me for $10.00.  Your support will
  143.     allow me to keep writing utilities such as this and/or
  144.     expanding them.  Any comments or suggestions will be greatly
  145.     appreciated also.
  146.  
  147.     Please send a check or money order for $10.00, along with 
  148.     any comments or suggestions to:
  149.  
  150.         Greg Barton
  151.         3334 NW 4th Street
  152.         Gainesville, FL  32609
  153.     
  154.     Phone: (904) 372-4765
  155.     BBS:   (904) 335-7289
  156.  
  157.     Thank you for your support of this program.
  158.  
  159. History:
  160. ────────
  161.    *    04/03/93 - Version 1.0 released to local beta testing.
  162.    *    04/05/93 - Version 1.1 released - Fixed "bug" where Postlink
  163.     writes a different LOG file depending on import/export status.
  164.    *    06/08/93 - Version 2.0 released - Bulletin was not generating
  165.         totals if POSTTERM was used instead of a third-party communications
  166.         program.  Fixed - note that it is no longer necessary to specify
  167.         an "A" or "M" in the .CFG file for automatic or manual import.
  168.         RIMBULL will read the log file correctly no matter what mode is
  169.         used.
  170.  
  171.     End of History.